# ESP32-S3 硬件规格与快速上手

```{admonition} 本文引用的文件
:class: note

- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/1_hardware/1_3_IO.rst](../../../products/mpython-s3/1_hardware/1_3_IO.rst)
- [esp32s3/docs/2_software/1_2_vscode.rst](../../../products/mpython-s3/2_software/1_2_vscode.rst)
- [docs/docs/zh_CN/board/drive.rst](../../../products/mpython/board/drive.rst)
- `esp32s3/firmware/boards/deploy.md`
- `esp32s3/firmware/boards/deploy_flashmode.md`
- `esp32s3/firmware/boards/mpython_v3/board.json`
- `esp32s3/firmware/boards/labplus_Ledong_v2/board.json`
```

## 产品概述
本指南面向ESP32-S3系列板型（以掌控板3.0 mpython_v3与乐动掌控2.0 labplus_Ledong_v2为主），聚焦以下目标：
- 明确板载硬件参数、引脚与接口能力
- 提供驱动安装、固件烧录与开发环境搭建的实操步骤
- 帮助初学者快速完成“装驱动—配环境—刷固件—跑示例”的完整流程

适用场景：创客教育、物联网原型、音视频交互、传感器数据采集、BLE/WiFi通信等。

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:1-84](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)

## 核心业务流程
下图展示从“准备工具到运行程序”的关键链路，适用于ESP32-S3板型：

```text
flowchart TD
A["准备工具"] --> B["安装USB转串口驱动"]
B --> C["安装VSCode与Python扩展"]
C --> D["连接板子并识别端口"]
D --> E{"首次刷机?"}
E --> |是| F["进入下载模式(BOOT+RESET)"]
E --> |否| G["直接写入固件"]
F --> H["使用esptool写入.bin固件"]
G --> H
H --> I["复位后打开REPL/运行示例"]
```

要点说明：
- 首次或清除分区时，先擦除Flash再写入新固件
- 若自动识别失败，手动指定串口端口
- 部分板型需按住BOOT键再按RESET进入下载模式

**章节来源**
- `esp32s3/firmware/boards/deploy.md:5-52`
- `esp32s3/firmware/boards/deploy_flashmode.md:1-10`

## 功能模块清单
- 硬件能力
  - 处理器：ESP32-S3双核，主频240MHz，内置FPU，支持Wi-Fi与蓝牙5
  - 存储：16MB Flash + 8MB PSRAM
  - 显示：1.47英寸LCD彩屏（ST7789，320x172）
  - 音频：ES8388解码芯片 + NS4150功放，双麦克风，扬声器
  - 传感器：QMI8658C六轴、MMC5603磁传感器、LTR-308光线传感器
  - 输入输出：实体按键A/B/Reset、触摸按键P/Y/T/H/O/N、RGB灯×3
  - 供电：USB 5V或金手指3.3V，工作电压3.3V，最大工作电流约700mA
- 接口能力
  - 数字I/O：20通道（含PWM、TouchPad）
  - 模拟输入：6通道12位ADC（P0~P4, P6）
  - 通信：I2C、UART（1路，115200bps）、SPI
  - LCD屏：SPI接口（BL/CS/RS/SCK/SDA）
  - 音频：I2S接口（DOUT/MCLK/DIN/BCK/LRCK）

验收要点：
- 确认各外设能在MicroPython中通过标准API访问（Pin/I2C/UART/SPI/ADC/PWM/Touch）
- 屏幕可刷新显示，音频可播放/录音，传感器数据可读
- WiFi/蓝牙可建立连接（视固件配置）

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:11-61](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/1_hardware/1_3_IO.rst:4-55](../../../products/mpython-s3/1_hardware/1_3_IO.rst)

## 数据与状态
- 板型与特性标识
  - mpython_v3与labplus_Ledong_v2均声明mcu为esp32s3，支持BLE、外部Flash、外部RAM、WiFi
- 构建与部署
  - 板级配置文件包含features、mcu、deploy指引等元信息，用于生成/选择对应固件包
- 运行时状态
  - 首次上电或擦除Flash后需重新烧录固件
  - 下载模式下设备枚举为串口设备，便于esptool写入

```text
graph TB
subgraph "板型配置"
V3["mpython_v3/board.json"]
LD["labplus_Ledong_v2/board.json"]
end
V3 --> |mcu=esp32s3| FW["固件镜像"]
LD --> |mcu=esp32s3| FW
FW --> |部署| DEV["目标设备"]
```

**图表来源**
- `esp32s3/firmware/boards/mpython_v3/board.json:1-25`
- `esp32s3/firmware/boards/labplus_Ledong_v2/board.json:1-25`

**章节来源**
- `esp32s3/firmware/boards/mpython_v3/board.json:1-25`
- `esp32s3/firmware/boards/labplus_Ledong_v2/board.json:1-25`

## 关键约束与边界
- 驱动与系统
  - Windows/macOS需安装CP210x驱动以识别USB转串口；未自动安装时需手动下载
- 开发与工具链
  - 推荐使用VSCode + Python扩展；后续可结合ESP-IDF扩展进行更底层开发
- 烧录限制
  - 首次或异常后建议先擦除Flash再写入
  - 下载模式需配合BOOT/RESET按键组合
  - 波特率过高可能导致写入失败，可降级重试
- 硬件边界
  - 供电上限与负载电流需满足设计，避免过流
  - 部分引脚被板载外设占用（如声音/光线传感器），不可同时作为通用IO

**章节来源**
- [docs/docs/zh_CN/board/drive.rst:1-14](../../../products/mpython/board/drive.rst)
- [esp32s3/docs/2_software/1_2_vscode.rst:29-55](../../../products/mpython-s3/2_software/1_2_vscode.rst)
- `esp32s3/firmware/boards/deploy.md:5-52`
- `esp32s3/firmware/boards/deploy_flashmode.md:1-10`
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:54-61](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)